home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / README < prev    next >
Text File  |  1994-08-01  |  34KB  |  609 lines

  1.  
  2.                    DEVELOPER TOOLBOX, VERSION 4.2, AUGUST, 1994
  3.           To use this CD to its fullest, you must be running IRIX 5.2
  4.  
  5.  
  6.  Welcome to the Developer's Toolbox!
  7.     
  8.  The Developer Toolbox is a CD product currently produced and distributed four
  9.  times a year to all registered software and hardware developers.  It contains 
  10.  various tools, utilities, SGI src code plus binaries and on-line information 
  11.  for the purpose of helping developers learn about, and write, code for IRIS 
  12.  workstations.   This software and information is intended for use by beginning
  13.  and advanced IRIS programmers.  The philosophy driving the ongoing creation 
  14.  and production of this CD is to provide our developer community with as much 
  15.  leading/bleeding edge software, hardware information, documentation, FAQ 
  16.  lists, binary tools and tilities not available to the general SGI customer 
  17.  base so they are as "up-to-the-minute" as possible in understanding where SGI 
  18.  is going.  Version 4.1 of the Developer Toolbox is entirely built upon 5.2 
  19.  IRIX.  No guarantees are made as to whether this now compiles or runs on 
  20.  releases prior to IRIX 5.2.
  21.  
  22.  NOTE:  the public/TeX/*.tar files are not present on v4.2.  space was squeezed
  23.         past the breaking point this time, so the *.tar files in the TeX 
  24.     distribution, unchanged since v4.1, are not included here.  but these
  25.     files *are* on the v4.1 CD.  everyone not in the program before now 
  26.     will receive v4.1 along with this CD, so all will have all the "bits" 
  27.     comprising v4.2.  this "shift in design" is also discussed in 
  28.     public/README and public/TeX/README.
  29.       
  30.                           VERSION 4.2 NEW ADDITIONS:
  31. utilities[+src]:
  32.  * cmapdoctor, scanner/viewer for all X cmaps/visuals (over/under -lays, popups)
  33.  * xshowcmap extension, for debugging probs with multiple colormaps/visuals;
  34.  * gmemusage, a graphical program-system memory usage display tool;
  35.  * gvi, provides a graphical user interface to the vi(1) text editor;
  36.  * CD mastering mkisofs binary creates an ISO-9660 filesystem image;
  37.  * updated pcnfsd daemon software tree;
  38.  
  39. digital media:
  40.  * library + examples provide video prog'er w/simple programmatic interface on 
  41.    top of the VL;
  42.  * harmonizer, real-time audio pitch bender example program;
  43.  * example programs using libmidi.a illustrate basic use of the MIDI library;
  44.  * sonic, real time audio spatialization example with graphics;
  45.  
  46. viewkit:
  47.  * VCal, a calendar program with alarms;
  48.  * builderExamples, programs written using BuilderXcessory;
  49.  * xcontact, Address Book and/or Contact Management program;
  50.  * other Vk app source: cmapdoctor, gvi, oat, security, uucpVadmin;
  51.  
  52. games:
  53.  * vroom, swank OpenGL slot car racing in the future;
  54.  
  55. texture mapping:
  56.  * Texture Mapped `smoke' special F/X implementation + documentation;
  57.  * "Fast Shadows and Lighting Effects Using Texture Mapping" PostScript file;
  58.  * "Texture Mapping as a Fundamental Drawing Primitive" PostScript file;
  59.  
  60. OpenGL:
  61.  * "The Design of the OpenGL Graphics Interface" PostScript file;
  62.  * OpenGL Attribute Tester tests OpenGL functionality on different platforms; 
  63.  * picking prog w/X overlay on top of an RGBA, double- & depth- buffered window;
  64.  
  65. swtools:
  66.  * libdmalloc, debugging malloc lib useful for finding memory corruption, uses 
  67.    DSOs to plug in a different malloc library;
  68.  * src + updated doc files for DWARF, a binary debugging-information-format;
  69.  * "The Silicon Graphics Delta C++ Compiler" White Paper, (Preliminary), 18 pgs,
  70.    new C++ compiler supports C++ shared lib evolution & speeds up build process;
  71.  * syms, script lists exported functions in libs, and as "undef" to ensure all 
  72.    unresolved symbols are accounted for;
  73.  * new one-stop-shop sgi sw inst dir at top-of-tree
  74.  
  75. speech recognition:
  76.  * updated beta inst images of speech products for eoe and dev (more vocab);
  77.  
  78. network:
  79.  * "HIPPI Performance on IRIX 5.2" white paper, + 2 accompanying source progs; 
  80.  * "Establishing a PPP connection using IRIX PPP" paper;
  81.  * "SLIP Installation and Configuration Guide" paper;
  82.  * 122 new Request For Comment files, now up to rfc1663 + 28 new PS versions;
  83.  
  84. Inventor:
  85.  * modified src from inventor_dev.src.sample handles the Spaceball input device;
  86.  * OpenIV prog uses draggers for direct manipulation of a surface of revolution
  87.    (with its own run-time DSO);
  88.  * Open Inventor files demo an interactive direct manipulation of a Track Light;
  89.  * sample OpenIV files demo use of draggers & engines in "self-manip'ing" examps
  90.  
  91. html docs:
  92.  * nascent murmurings of a toolbox.html home page references the following:
  93.  * Inventor FAQ + Known Bugs, Fixes, & Workarounds--from Silicon Surf www site;
  94.  * MIPS ABI Information Directory includes a FAQ on porting to the MIPS ABI;
  95.  * html document on InPerson desktop conferencing sw product;
  96.  * rayshade Reference Guide, plus "how to" guide document sets;
  97.  
  98. IRIX:
  99.  * "REACT in IRIX V.5 Technical Report" for real-time extensions to IRIX 5;
  100.  * file describing colormap usage differences between 5.1* and 5.2;
  101.  * list of 5.2 IRIX patches, information current as of 7/20/94;
  102.  
  103. public:
  104.  * LinkWinds, a visual data analysis and exploration system designed to rapidly
  105.    and interactively investigate large multivariate and multidisciplinary data 
  106.    sets to detect trends, correlations and anomalies.  It accepts HDF, CDF, 
  107.    netCDF, FITS, PDS, SGI RGB, and binary byte and floating point data;
  108.  * rayshade 4.0.6, swank ray tracing pkg modified to output sgi img file format;
  109.  * "Free Widget Foundation" flexible widgets compliments of X user community;
  110.  * xdbx in sgi-inst image form, contains executables for IRIX 5.2+;
  111.  * FTP sites file, updated 7/26/94;
  112.  * 5/29/94 Version 2.0 Beta of psgl;
  113.  * 7/11/94 released version of plan;
  114.  * version1.77 of CLRview;
  115.  * updated version 3.2 of libtiff;
  116.  
  117. GLX:
  118.  * texvol, performs volume rendering using 2d or 3d textures;
  119.  
  120. performance tuning:
  121.  * "Performance optizations, implementation, and verification of the SGI 
  122.    Challenge multiprocessor" PS doc;
  123.  
  124. Xlib:
  125.  * 2 programs--one using "Font", the other "Pixmap"--cursors in X;
  126.  * 2 X font programs, one working with glyphs, the other doing scalable fonts;
  127.  
  128.                  also included (pre-version 4.2 vintage):
  129.  
  130. search tools:
  131.  o two complimentary top-of-tree search mechanisms scripts:
  132.    * "sifttree" provides multiple keyword search for strings, document 
  133.       filenames or title strings, occurring anywhere in the FAQs, documents, 
  134.       lib, public, utilities, GoldMedal, hardware, perfTuning, or src, subtrees,
  135.    * "findfuncs" identifies the location of specified library functions in the
  136.       public, lib and src subtrees;
  137.  
  138. image data:
  139.  o satellite image mosaics of earth from space created from visible & infra-red
  140.    channels, with sea surface temperature data added for ocean areas & the base
  141.    satellite imagery enhanced with shaded relief data;
  142.  
  143. educational software:
  144.  o software from SGI's Technical Education Department for OpenGL programming
  145.    classes:  "OpenGL Programming 1 Course" (basics), and "OpenGL Programming 2
  146.    Course" (addressing more advanced issues);
  147.  o geometer:  graphical tutorial (including source) illustrates concepts of 2-D
  148.    Euclidean & projective geometry in 5.2-version now using jot;
  149.  
  150. texture mapping documents:
  151.  o "Accelerated Vol. Rendering & Tomographic Recon. Using Texture Mapping Hdw",
  152.  o "Interactive Geometric Image Transformation Using Texture Mapping" papers;
  153.  
  154. speech recognition:
  155.  o beta inst images of speech products for eoe and dev;
  156.  o binary utilities to enhance one's speech run-time environment;
  157.  o basic speech recognition example programs;
  158.  
  159. utilities:
  160.  o SGIHelp development tools as inst-able images to integrate help w/an app in
  161.    the Indigo Magic User Environment;
  162.  o "fss," binary for finding which subsystem a file is installed from;
  163.  o CD mastering scripts now do more error checking and will be able to handle
  164.    sa files (putting sashes on the volume header, etc.);
  165.  o uil2VK:  viewkit experimental replacement code generator module used with
  166.    BuilderXcessory so BX can generate ViewKit-compatible code;
  167.  o parasol:  analyzes FORTRAN src to assist in parallel porting.  A static 
  168.    analyzer to identify global data dependencies in Fortran from a specified 
  169.    thread point, valuable in identifiying common blocks to be made local or to 
  170.    be locked;
  171.  
  172. OpenGL:
  173.  o opengl-based version of ipaste;
  174.  o dinomometer:  synthetic modeling benchmark for OpenGL;
  175.  o textfun:  a "poor man's OpenGL-Motif font manager" program;
  176.  o xmblur:  OpenGL-motif motion-blur program;
  177.  o debugHelper overrides DSO functions to trace OpenGL program calls without 
  178.    having to recompile;
  179.  o 40 OpenGL-and-Xlib-only example programs, including 2 implementing pure-Xlib
  180.    version of "IrisGL-type" pup menu capability;
  181.  o "OpenGL & X" tutorial files from 8th Annual X Technical Conf in Boston, 1/94;
  182.  o libGLColorChooser.a:  an OpenGL implementation of the SgColorChooser widget;
  183.  o 2 implementations of opengl-glx extensions;
  184.  o lists mapping Iris GL commands to similar OpenGL ones in PostScript & ascii;
  185.  o nurbsTrim:  makes a trimmed NURBS surfaces in OpenGL and Inventor;
  186.  o "OpenGL(tm) and X, Part 1/Part 2/Part3:  An Introduction/Using OpenGL with 
  187.    Xlib/Integrating OpenGL with Motif" PS copy from "The X Journal" + src code;
  188.  o software-stereo-in-a-window boilerplate examples in opengl-motif;
  189.  o opengl motif-based interference checking demo;
  190.  o Xt/Motif widget for GL/OpenGL rendering, switchable between single & double 
  191.    buffering;
  192.  o renderboth, renders with X and OpenGL to the same window using a standard
  193.    motif XmDrawingArea widget as the rendering medium;
  194.  o LARGE OpenGL tree of src (Xlib-only as well as Motif), documentation, and
  195.    articles, isfast (performance measure routines), and xglinfo (displays info
  196.    about an X server supporting the OpenGL extension, especially wrt visuals);
  197.  o an Analysis of PEX 5.1 and OpenGL 1.0 in the documents tree;
  198.  
  199. video:
  200.  o seqgrab:  VL sequential frame accurate capture source (Galileo/VLAN);
  201.  o security:  source for video camera doing stopframe and motion detection;
  202.  o source for galileo.sw.demos video progs using VL+motif or VL+IrisGL demo'ing
  203.    special effects like chroma and luma keying, blends & transitions, and also 
  204.    capturing video frames for painting or putting onto 3-D geometry;
  205.    (Galileo/Indigo 2 Video/Indy Video)
  206.  o vidmap:  texture-mapping of video, using SGI's movie/video/compression/audio
  207.    libraries.  Selection can be a live source such as IndyCam, other live video
  208.    sources, or movie file (SGIMF, QuickTime), to be texture-mapped to a polygon;
  209.  o scrollmon:  creates realtime scrolling credits (from either anti-aliased text
  210.    or SGI rgb images) or titles for video production;
  211.  o the "SGI Digital Video Specification" including the data format, electrical
  212.    and mechanical interfaces used to get digital video data into and out of
  213.    SGI platforms via this 60-pin connector;
  214.  
  215. audio:
  216.  o DAT examples:  command interface, copying, & DAT checking programs;
  217.  o simulated reverberation source code for real-time audio;
  218.  o lackey:  speech aware app launcher developed using SGI's speech recog. sw. An
  219.    intro to using speech API & architecture of speech sw sys;
  220.  o ascope, displays the left channel of data coming in from an audio port;
  221.  o rock, indigo memorial barbeque theme song rapp as constructed & sung by mr. 
  222.    totally insane(tm) himself;
  223.  o cd-catalog contains music catalog files for CDman(1) and cdplayer(1).
  224.  o audio apps, including a generator of a small series of eight single-cycle
  225.    waveforms, & programs generating oscillators & waveforms, loop audio samples,
  226.    change playback rate, mix and pitch, and sends output to the speaker;
  227.  o "Audio Interchange File Format AIFF-C, A revision to include compressed audio
  228.    data" PS doc;
  229.  
  230. X:
  231.  o paper & src discussing/demonstrating implementation of a 3-color cursor in X;
  232.  o XtAppInitwIcon src similiar to XtAppInitialize but enables app to generate 
  233.    icon window for top-level shell that generates multi-colored (> 2) icons;
  234.  o information files pertinent to X and system performance issues;
  235.  o an SGI internal paper on Motif Performance Notes in the documents tree;
  236.  o papers on SGI's Xserver:
  237.    * "Going Beyond the MIT Sample Server:  The Silicon Graphics X11 Server",
  238.    * "Programming X Overlay Windows",
  239.    * "A Fully Functional Implementation of Layered Windows",
  240.    * "X Server Multi-rendering for OpenGL and PEX";
  241.  o X11R5 Input Extension Library PostScript files:
  242.    * "X11 Input Extension Library Specification",
  243.    * "X11 Input Extension Porting Document",
  244.    * "Appendix A,  Input Extension Protocol Encoding",
  245.    * "X11 Input Extension Protocol Specification",
  246.    * /usr/lib/X11/input/config/README, (released in the fall) with info on
  247.      device controls & SGI extensions to change and query things about devices;
  248.  o PostScript doc on "XPM, The X PixMap Format",
  249.  
  250. IRIX:
  251.  o irix tree with shell scripts, UUCP vadmin tool, irix/system -level progs;
  252.  o sproc/semaphore src can raise sub-process's priority/circumvent preemption;
  253.  o dir of docs on c++-rules.ps, (/usr/include/make/)commonrules.ps, "Silicon 
  254.    Graphics Makefile Conventions," and cpp/csh/make/pmake quick references;
  255.  o irix5.2 + New Products Info directory in documents subtree including:
  256.    * 2 files on HIPPI:  New Product Bulletin + QnA's,
  257.    * question-and-answer on the Indigo Magic User Environment Interface,
  258.    * major changes between the 4.X and 5.2 versions of the Installation Guide,
  259.    * IRIS Media Libraries New Product Information on dmedia_dev and svideodev,
  260.    * Periodic Table of IRIX O.S.'s 3-page showcase file--CURRENT AS OF 4/13/94,
  261.    * Software Compatibility Matrix for software product numbers and software 
  262.      releases from 4.0.1 to 5.2,
  263.    * Field Information Bulletin #414 documenting known bug: "Indigo2 XZ/Extreme
  264.      stipple register causes graphics problems on IRIX 5.2",
  265.    * guidelines for the use of the /usr/share filesystem.
  266.  
  267. Silicon Studio:
  268.  o "Creative Destinations, Silicon Studio Training Centers" describes eight
  269.    locations in Europe and North America and what they each offer;
  270.  o "Silicon Studio Technical Report" covering video and compression products
  271.    including Gailieo Video, Indy/Indigo^2 Video, Cosmo Compress, and Sirius 
  272.    Video;
  273.  o "The Silicon Studio for Publishing Environment from Silicon Graphics"
  274.  
  275. Inventor:
  276.  o OpenInventor lab source plus solutions;
  277.  o 38-page showcase presentation on "Open Inventor 3d Toolkit";
  278.  o noodle, an easy-to-use 3D object-modeler rich in using Open Inventor.  
  279.  o "How to Write an Open Inventor File Translator" PostScript file;
  280.  o "Open Inventor Nodes Quick Reference" Guide PostScript file;
  281.  o shared scene viewer lets multiple users on the net view/change same iv file;
  282.  o soundspheres:  a very primitive spacial audio program in Open Inventor;
  283.  o DxfToIv binary/man page, converts AutoCad's DXF format files to IV files,
  284.  
  285. performance tuning:
  286.  o showcase slide set used to teach program performance tuning;
  287.  o cheat sheet for gldebug, useful for both debugging and tuning;
  288.  o cheat sheet for glprof, useful for profiling Iris GL applications;
  289.  o scripts to parse and quantify gldebug.history data;
  290.  o 100+ showcase "pages" on Challenge I/O performance+scripts+PS files:
  291.  o document on benchmark results on 100/150 Mhz Challenge L/XL servers & Onyx;
  292.  
  293. hardware:
  294.  o 5.2 EISA/ISA driver source for a device driver for the Comtrol Hostess 550 
  295.    Serial Port Board;  
  296.  o User Level SCSI DAT driver:  great example of how to use the devscsi library!
  297.  o Roland RAP-10 ISA driver - an example of how to do DMA on the EISA bus;
  298.  o two SGI manuals--"IRIX Device Driver Programming Guide" and "Reference
  299.    Pages"--as inst images, explain writing device drivers for Irix5;
  300.  o 2 prog sets to allow joe user (doesn't have to be root) mounting of either
  301.    a CD-ROM or a Magneto-Optic (MO) drive to an SGI system;
  302.  o example of how to program for the parallel port;
  303.  o an expanded SGI-Hardware FAQ including a list of Q&As culled from the last
  304.    1800 messages (as of late October, 1993) to comp.sys.sgi.hardware;
  305.  o files required to build and test the Summagraphics 6x9 tablet driver;
  306.  o files describing how to write a device driver for a GIO board on an Irix 5
  307.    system software platform;
  308.  o VME interface document for the Personal Iris, 4D100-4D400 series machines,
  309.    and Crimsons.  (Does NOT cover IO4 board);
  310.  o GIO_DRVR4.0.5 subdir in the hardware tree, with info about writing a device
  311.    driver for a GIO board;
  312.  
  313. software tools:
  314.  o mipsABI on-line FAQ w/reader (included both as source and inst-able image);
  315.  o crpt, script that generates a kernel core file report;
  316.  o MMmalloc, a new libmalloc, faster, better memory utilization with recycle;
  317.  o technical review of ""The Annotated ANSI C Standard" + ANSI C rationale text;
  318.  o mipsABI porting materials includes:
  319.    * "MIPS Processor ABI Conformance Guide Version 1.1.1" (the "Black Book")
  320.      in PostScript,
  321.    * porting examples,
  322.    * PostScript document on how to build an ABI-compliant binary on IRIX 5.2;
  323.  o DSO subtree with 1993 forum slides + 8 case studies;
  324.  o DSO example program demonstrating the implementation and use of a DSO;
  325.  o "Question-and-Answer" info snarfed from external/internal-to-SGI news groups
  326.    on compilers issues;
  327.  o 2 progs providing alternate implementations of a function printing a stack
  328.    traceback of the calling program.
  329.  o gencall, generates a high-level programming interface to the MIPS calling
  330.    convention on SGI machines;
  331.  o dbcopy, a faster version of the memory copy routines than is found in libc
  332.    in 5.1 and before;
  333.  o trubasic, the True BASIC programming language with a 250-line limit on progs
  334.    which can be run with little or no modification on MACs and PCs;
  335.  o optimization documents directory with PostScript copy of:
  336.    * chapter 1:  "Using the Compiler System", from the "Irix Programming Guide",
  337.    * chapter 3:  "Improving Program Performance", from "Irix Programming Guide",
  338.    * Introduction chapter of the "Irix Programming Guide",
  339.    * chapter 3:  "Dynamic Shared Objects", from "IRIX System Programming Guide";
  340.  o 64-bit documents in PostScript:
  341.    * "Preparing for the 64 bit Future of IRIX",
  342.    * "Native 64-bit Subprogram Interface for MIPS Architectures",
  343.    * "64-bit C Porting Guide",
  344.    * 64-bit C and Fortran variable sizes file,
  345.  
  346. printers:
  347.  o list of ALL SGI-supported printers (and scanners), w/notes including which 
  348.    supported by Impressario;
  349.  o lpr, a script enabling default lp printing to be dumped to lpr(1);
  350.  o ps_fonts:  progs check whether PS device allows printing of all characters;
  351.  
  352. FAQs:
  353.  o Frequently Asked Questions--13 SGI-specific, 29 general--file listings in 
  354.    subtree at top-of-tree;
  355.  
  356. games:
  357.  o IndiZone games binaries:  blackbox, pods, and sb (Space Boulders), and Tom
  358.    Benoist's classic solitaire game, klondike;
  359.  o source for three IndiZone I games:  oort, portfolio, and sw (Spacewar);
  360.  o IndiZone II games source code for blix, cycles, gold, and tagh;
  361.  o source for SGI's classic "buzzwordBingo", cubetris, and seahaven games;
  362.  
  363. paul haeberli's universe/image stuff:
  364.  o icmp, provides visual comparison of two images with or without alpha channel;
  365.  o src/haeberli/libimage/README.spec definitive doc describing SGI img file fmt;
  366.  o src/haeberli/pstools contains boss PostScript processing tools for the IRIS;
  367.  o src/haeberli/jpeg file format image de-/compression sw including libjpeg.a,
  368.    cjpeg, and djpeg and support to manip SGI image files to/from jpeg format;
  369.  o src/haeberli/vidpan:  tools for controlling a Panasonic Video disc recorder;
  370.  o src/haeberli/vidsony:  tools to control SONY LVR-5000 Video disc recorder;
  371.  o src/haeberli/mpeg has public domain MPEG video software decoder;
  372.  o src/haeberli/{libimage, libgutil, libcan, libtiff} complete source;
  373.  o src/haeberli/images contains over 30MB of sgi RGB image files;
  374.  o src/haeberli/128env:  collection of spherical environment map images;
  375.  o src/haeberli/128tex:  collection of small texture map images;
  376.  o src/haeberli/envmaps:  cubical format environment maps;
  377.  o src/haeberli/fonts:  outline fonts in our polygonal outline font format;
  378.  o gobs of programs in haeberli/{abekas, envtools, fonttools, imgtools,
  379.    impression, objtools, tools, vidtools}, plus autopaint, compexp, enhance, 
  380.    imp, leep, movie, mtex, styline, tritest, vidiot, vortest;
  381.  o src/apps/ibrowse:  extraHEEMEly swank image file browser;
  382.  o src/apps/opaste:  pastes images/text into the overlay/popup planes;
  383.  
  384. network:
  385.  o "Asynchronous Transfer Mode:  Implementations for 1994" PostScript document;
  386.  o a TCP->UDP updated xconf router so people can use it over the Internet;
  387.  o PC-NFS daemon providing authentication & print spooling services access from
  388.    one's PC to IRIX when used with Sun's PC-NFS software;
  389.  o short_timer checks if remote host responds quickly, avoiding long wait for 
  390.    network timeout;
  391.  o networking example prog: rpcdemo & printout link-level address of e-net or 
  392.    FDDI interface;
  393.  o X-based local area network conferencing program;
  394.  o Internet Request For Comments (RFCs) contains current set of open standards 
  395.    used on the Internet today, + doc (63+ MBs) on virtually every aspect of 
  396.    the Internet, since its inception;
  397.  
  398. exampleCode:
  399.  o example source for 5.2 Iris GL software-stereo-in-a-window or "SoftStereo";
  400.  o I18N examples of internationalization & localization with implementation of
  401.    wide characters for string manipulation & XPG/3 and MNLS message cataloging;
  402.  o Inventor src/documentation/data files & full-function scientific calculator;
  403.  o additional Inventor Nodes and audio and Inventor Classes;
  404.  o new version of the SGI GLX mixed model Motif double-buffered overlay program; o an Xlib GLX mixed model interface checking and capping demo;
  405.  o example implementations of (4.0) mixed model programming;
  406.  o GLX "dualhead" example code illustrates basics of writing code taking
  407.    advantage of multiple screens;
  408.  o SciTex, a paper and example code describing "Texture Mapping in Technical,
  409.    Scientific and Engineering Visualization";
  410.  o gameOfLife prog implemented using the stencil planes;
  411.  o fconv, Motif-based numeric format conversion utility for hex, octal & decimal
  412.    equivalents;
  413.  o 3Dmodeling routines (and example programs) to help build solid models;
  414.  o IrisGL demonstration of a technique to "cap" clipped (cut-away) solid object; o calc:  Iris GL implementation of a Reverse Polish Notation calculator;
  415.  o swirl:  Iris GL texture generator program for texture maps;
  416.  o example src and paper on constructive solid geometry;
  417.  o programs implementing drawing in the stencil planes;
  418.  
  419. demos:
  420.  o source code for 45 SGI demos:
  421.    * OpenGL-based:  atlantis, backtrace, drip, fadeflip, ideas, insect, lorenz,
  422.                     puzzle, space, stonehenge, tex_cube,
  423.    * Irix 4 GLX-based video:  specialfx, vidtmesh, vidpaint, trails, bigvideoin,   * Irix 4 GLX-based:  demobook,
  424.    * general Iris GL:  atlantis, bounce, buttonfly, closeup, curve, demograph,
  425.                        dragon, flight, flip, ideas, logo, newave, newton, 
  426.                        rotimg, snoop, snurb,
  427.    * VGX-intended:  blob, envmap, morph, shadows,
  428.    * audio:  amesh, bz, drive, synthia,
  429.    * Reality Engine-intended:  atom, distort, fastshadows, and weather;
  430.  
  431. public domain/copyright software/shareware:
  432.  o src:  GNU[emacs 19.22, gnumake], HPGL, ImageMagick, RTF, SciAn, Xpm, Xprof,
  433.          agrep, cdsend, dbmalloc, fax, jpeg, oneko, patch, plan, psgl, radio,
  434.          rsynth, sgiCD, shar, sox, tarmail, tuner, vis5d, xcdplayer, xpd;
  435.  o binaries:  CLRview, LinkWinds;
  436.  o inst-images: FWF, emacs19, flexfax, gzip, jpeg, plan, psgl, xdbx, xpd.
  437.  
  438. binaries:
  439.  o setfb - Irix 5 binary sets the effective frame buffer depth to 8 or 24
  440.    bitplanes and is intended for use by developers wishing to test their apps
  441.    in an 8-bit system, when what they have is a 24-bit system;
  442.    NOTE:  only usable with Indigo^2 XL and Indy machines.
  443.  o enhanced version of fsn (File System Navigator) now reads *relative* paths.
  444.    Check out fsn as an alternative to visually scanning the Toolbox tree;
  445.  o inout+backat:  groupware prgs establish an In/Out board on a local network;
  446.  o tiepoint:  demos use of Control|Tie points to determine coefficients of a 
  447.    polynomial warping function;
  448.  
  449. math libraries:
  450.  o math libraries and programs for implementing optimized parallel programs:
  451.    * libconv:  features Convolutions for FIR and IIR filters together with
  452.      correlations, plus PS doc,
  453.    * libblas:  Basic Linear Algebra Subprograms,
  454.    * libfft:  utilities for performing Fast Fourier Transforms (FFT), including
  455.      one, two and three dimensional FFT's,
  456.    * psort:  a parallel implementation of the Merge-Sort algorithm,
  457.    * skylib.a:  library of Fortran 77 routines for solving linear systems of
  458.      equations where the matrix is banded, with the bands varying in width,
  459.      and stored in a packed form known as skyline;
  460.  
  461. Multi-Processor implementations:
  462.  o subtree for parallel programming applications issues, includes how to
  463.    combine mips1 & mips2 objects into a single mips1/2 executable thru a jump
  464.    table implementation, and a using a high resolution timer of the io3 board
  465.    on an r4k-based SGI system;
  466.  
  467. AND,
  468.  
  469. other TOP-OF-TREE information files besides this one:
  470.   Toolbox.contents:  a complete summary of the Toolbox software contents;
  471.   Toolbox.index:     an alphabetized index of all binaries & libraries on the
  472.                      CD, accompanied by path-location & 1-line description;
  473.   Toolbox.path:      abbreviated form of Toolbox.index w/path-location only;
  474.   Makefile.README:   Irix 5 gotcha's to be aware as far as make is concerned;
  475.   README.Inventor:   how compile with Open Inventor 2.0 *and* Inventor 1.1.2
  476.                      libraries and headers on the same machine;
  477.   findfuncs.README:  how to search for library routines in lib/public/src;
  478.   sifttree.README:   how to perform multiple keyword/filename searches;
  479.  
  480.    Two powerful search mechanisms--sifttree and findfuncs--both enable quick
  481.    and effective means for determining if anything one is looking for exists
  482.    in any form in the Toolbox.  sifttree searches the entire Toolbox CD based 
  483.    on a multiple keywords list and/or document filename (or pathname) field.
  484.    See sifttree.README for all the details.  findfuncs takes 1 to n library 
  485.    function names and returns the paths from the top-of-tree to whichever 
  486.    program(s) in the CD employ these functions.  See findfuncs.README for all 
  487.    the details.
  488.  
  489.    demobook provides a visual-interface browser to the Toolbox where one can
  490.    launch binaries, or read information files.  The visual paradigm is a
  491.    library of books on shelves, and provides an easy way to visually scan the
  492.    contents of the Toolbox--if nothing else, see the "new stuff" book with 
  493.    everything new in version 4.1 in the middle of the top shelf.  To explore 
  494.    this interface, run the "toolbox" script in the top directory of the CD-ROM.
  495.  
  496.    In Version 4.2, demobook groups the contents of the Toolbox into the
  497.    following categories displayed as books -- "bin", "perf tuning", "network",
  498.    "games", "video", "documentation", "OpenGL", "utilities", "Gold Medal",
  499.    "new stuff", "inventor", "viewkit apps", "IRIX", "X stuff", "texture 
  500.    mappping", "public", "sw tools", "speech", "audio", "example code", "GLX 
  501.    Motif", "font stuff", "image stuff", "teacher", "FAQs", "hardware", "OpenGL 
  502.    Demos", "Indy stuff", "OpenGL Prgming Bk", "mathlib stuff", "GLX Xlib/Xt", 
  503.    "stereo - vis", "Reality Demos", "GL tools", "stereo - aud", "GL Demos", 
  504.    and "Master Index".  All new additions plus updated stuff to Version 4.2 
  505.    reside in books on the top shelf thru the "font stuff" book on the second 
  506.    shelf, (except for "Master Index" which contains an icon for every icon in 
  507.    every other book in the library).
  508.  
  509.    Press LEFTMOUSE on any book to open it (MIDDLEMOUSE opens the book without
  510.    animation).  Press LEFTMOUSE over the left- or right -hand page edges area
  511.    to turn the page to the left or right respectively (MIDDLEMOUSE turns pages
  512.    without animation).  On any given page there is a graphical icon button for
  513.    each program/document.  To select a button, place the cursor over the icon,
  514.    and double-click LEFTMOUSE.  This will either launch the program, or bring
  515.    up a window shell with an ascii information file, or launch a previewer for
  516.    a PostScript or showcase file.  There are three kinds of "Developer Toolbox"
  517.    icons:
  518.  
  519.    * yellow and green box beneath "Developer Toolbox" -- binary file
  520.      double-clicking here will launch a binary file.
  521.  
  522.    * blue "ascii" text beneath "Developer Toolbox" -- ascii file
  523.      double-clicking here will "more" some sort of ascii file inside an xwsh.
  524.  
  525.    * red "PS" text beneath "Developer Toolbox" -- PostScript or Showcase file
  526.      double-clicking here will run xpsview/showcase for the given file type.
  527.  
  528.    RIGHTMOUSE closes whichever book is currently open and puts it back on the
  529.    shelf without any animation.
  530.  
  531.    IMPORTANT:  For demobook to run correctly, if dps_eoe.sw.dps is not loaded,
  532.                copy toolbox/.util/Xpsview2 to /usr/lib/X11/app-defaults.
  533.  
  534.    After sampling the software, you may want to copy some or all of the code
  535.    from the CD-ROM to your workstation.  Although you may copy the software to
  536.    any disk with enough space, it is intended to be copied into the
  537.    "/usr/people/4Dgifts/toolbox" directory.  Local Makefiles are provided for
  538.    all source code.
  539.  
  540.    Total size of v4.2's tree, on the CD-ROM, is approximately 574+ megabytes.
  541.  
  542.    WITH THE EXCEPTION OF THE SOFTWARE RESIDING IN THE "PUBLIC" DIRECTORY, ALL
  543.    SOFTWARE CONTAINED IN THE DEVELOPER'S TOOLBOX IS CONSIDERED UNPUBLISHED,
  544.    PROPRIETARY, INFORMATION OF SILICON GRAPHICS, INC.  IT IS COVERED BY THE
  545.    NON-DISCLOSURE AGREEMENT WHICH IS REQUIRED FOR PARTICIPATION IN THE
  546.    DEVELOPER PROGRAM.  ANY USE, DUPLICATION OR DISCLOSURE OF THE SOFTWARE NOT
  547.    SPECIFICALLY AUTHORIZED BY SILICON GRAPHICS, INC. IS STRICTLY PROHIBITED.
  548.  
  549.  
  550.    janitor's corner:
  551.  
  552.     the janitor was going insane upon completion of v4.1, and so bailed out to
  553.   6-week vay-kay regeneration.  so much for predictions of a mosaicized d.t. 
  554.   by v4.2...  still, BIGGE things *are* in the offing--realistic expectations
  555.   plot a www site with an incarnation of a d.t."master tree" perhaps within the
  556.   next 6-9 months.  hence for those *with* internet access, an up-to-the-minute
  557.   complete tree will always be available for [sub-section] download (quoting 
  558.   frank from "Make A Jazz Noise Here", "coming soon to an airport near you"). 
  559.   for those without such access, the CD will remain at the other end of the 
  560.   toolbox publishing spectrum.
  561.     in spite of such lame excuses for there not being more sheer volume of new
  562.   haps', the janitor is pleased to present the swank-o-rettes that did make it
  563.   in under the wire.  the runner-ups to the Gold Medal award were an intense
  564.   pack o' hound-of-the-baskervilles wanna-bees.  all beefy, all stout, all
  565.   inspired contenders, with a great deal to recommend each of them.  but the
  566.   janitor had to choose only one and settled upon herr magster's sterling
  567.   creation.  shek-kowwwttt GoldMedal/README.GoldMedal.
  568.     it is possible v4.3 will be *relatively* co-incident with the "push" 5.3 
  569.   IRIX release.  hence the entire CD *may* be re-built on an IRIX 5.3 base.  
  570.   there will also be more actualized IRIX 6, 64-bit material.  and indications 
  571.   are we'll be able to include a mosaic client as well, so the miniscule, 
  572.   somewhat joke-of-a-start www/toolbox.html "home page" this go'round, will 
  573.   actually be something much more legitimate and substantial come v4.3.  (in 
  574.   fact, if the janitor is correct *this time* in his intention-predictions, 
  575.   there may actually be a second CD entirely devoted to html-incarnations.)  
  576.   see the www/README file for an explantion of how the current one needs yer 
  577.   help to breath and move.
  578.     as always, the pleading for pheedbak from ANYone about what works/doesn't 
  579.   work, what's missing, what's incomplete, what's useless, and what be boss to 
  580.   see more of on the D.T.  this thing can only be as good as the info flowing
  581.   back to me from all of you.  bugs, problems, confusion, anger, frustration, 
  582.   ideas, concerns, suggestions, stupification--puh-LEEZE contact:   
  583.                    dave@sgi.com 
  584.                    415/390-3556 (voice-box) 
  585.                    415/967-6239 (fax-me)
  586.                    we come to serve.  all responses *ARE* greatly appreciated.
  587.                    swanx for yer interest/participation,  
  588.                                                       dave ratcliffe
  589.  
  590.  extra special thanx to John Magdziarz, Chris Carlson, Ed Millard, Eric Miller, 
  591.  Doug Young, Scott Bovenizer, Eliot Lear, Roger Chickering, and the steadfast 
  592.  help/contribs/support of Sophie Lonsky, Michele Lord, Grant Dorman, Colm 
  593.  Sweetman, Mats Wichmann, Paul Issacs, Ann LaGrone, Gary Griffin, Don Hatch, 
  594.  Chuck Stein, Mike Yang, Mark Segal, George Kyriazis, David Watson, Dan Fink, 
  595.  Ralph Humphries, Robert Keller, Joel Tesler, Beth Van Eman, Greg Ferguson, 
  596.  Andrew Palay, Shankar Unni, Michey Mehta, Scott Henry, Victor Riley, Mike Gold,
  597.  Tim Wicinski, John Talbott, Chris Fouts, Craig Kolb, Louis "Borg" Oleson,
  598.  Lynda Marin, Jelle van Zeijl, Stephen Peter, Bud Jacobsen, Andy Berkin, Rodney
  599.  Hoinkes, David Youatt, Brian Crowley, Archer Sully, Andy Pinkard, Tom Barton, 
  600.  Ken Kubey, Bruce Bailey, David Anderson, Roger Brown, Bill Henderson, Thomas 
  601.  Driemeyer, Baron Roberts, Jym "powder daze" Terhorst, Don Bennett, Ivan Hajadi,
  602.  Mark Callow, Kate Weber, Russ Harris, Jim Hopkins, Rob Nunes, Mark Olson, 
  603.  Michael Sweet, Howard Lo, Tom Reed, David Story, Yusuf Attarwala, Terry Drasny,
  604.  Paul David, Rick Evans, Gavin Bell, Lance Welsh, Jay Gischer, Andy Cameron, 
  605.  Leslie Doyle, Rod Beckwith, Lynn Crilley, Paul Lacombe, Cindy Echaves, Ben 
  606.  Mahjoor, Rick Mcleod, Aaron Schuman, Carl Korobkin, Gianni Mariani, Gretchen 
  607.  Helms, Sam Leffler, Paul Haeberli, Pete Sullivan, Rob Mace, Jim Patterson, Eva
  608.  Manolis, Rikk Carey, Rolf Van Widenfelt, and Philip Ho
  609.